home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / vpix19f.zip / VIEWPIX.DOC < prev    next >
Text File  |  1992-02-23  |  10KB  |  244 lines
  1.  
  2.             ▒██  ▒██ ▒██ ▒███████ ▒██  ▒██ ▒███████ ▒██ ▒██  ▒██
  3.             ▒██  ▒██ ▒██ ▒██      ▒██  ▒██ ▒██  ▒██ ▒██ ▒██  ▒██
  4.             ▒██  ▒██ ▒██ ▒██████  ▒██  ▒██ ▒███████ ▒██   ▒███
  5.             ▒██  ▒██ ▒██ ▒██      ▒██▒█▒██ ▒██      ▒██ ▒██  ▒██
  6.              ▒█████  ▒██ ▒███████ ▒███████ ▒██      ▒██ ▒██  ▒██
  7.  
  8.                       NEW ONLINE GIF FILE VIEWING DOOR
  9.                   (C) 1991-1992 Frank Capo - No Anchovies
  10.                            ALL RIGHTS RESERVED
  11.  
  12.  
  13.                                  OVERVIEW
  14.  
  15.        Viewpix is a BBS Door which allows your users to preview .GIF
  16.        graphics files while online. VIEWPIX works in conjunction with
  17.        GIFDesk - a freeware utility written by Jay Wherley, and SHOWGIF,
  18.        a shareware program written by Bill Parquet. You are urged to
  19.        promote and spread the word about GIF Desk and SHOWGIF which are
  20.        excellent programs.
  21.  
  22.  
  23.                                INSTALLATION
  24.  
  25.                                DO THIS FIRST!
  26.  
  27.        In order for this Door to run properly, you MUST include a line
  28.        in your AUTOEXEC.BAT file that looks like this:
  29.  
  30.                               SET GIFDESK=FILE
  31.  
  32.        MAKE SURE YOUR USERS KNOW TO LOAD UP SHOWGIF FIRST ON THEIR SYSTEM
  33.        PRIOR TO USING THE DOOR! SOME USERS ASSUME THE DOOR WILL JUST SHOW
  34.        THE GIFS FOR THEM WITHOUT LOADING THIS INCREDIBLE TSR!
  35.  
  36. PACKAGE LIST
  37.  
  38.    VIEWPIX.EXE  -> Main Program
  39.    GIFDSK40.ZIP -> View Several Gifs
  40.    SHGIF55C.ZIP -> TSR Gif Viewing Utility
  41.    SAMPLE.LST   -> Sample File
  42.    SAMPLE.DIR   -> Sample File
  43.    SAMPLE.CNF   -> Sample Configuration File
  44.    VIEWPIXG     -> Ansi Screen
  45.    VIEWDOC.EXE  -> Self-Displaying colored Documents
  46.    VIEWPIX.DOC  -> This ASCII Documentation
  47.    FILE_ID.DIZ  -> Description automatically placed on Most PCB Systems
  48.    FILE.DIS     -> BBS Description
  49.    (See Also Appended Last Minute Files, If Any)
  50.  
  51. Place SHGIF55C.ZIP into a separate directory for now and unzip all the
  52. others into a subdirectory on your BBS drive. Multi-node systems must
  53. do the same for each node.
  54.  
  55. SAMPLE.CNF DESCRIPTION
  56.  
  57. C:\GAP                #1 -> Drive\Path to DOOR.SYS (or other door file)
  58. No Anchovies PC       #2 -> The name of your BBS
  59. GAP                   #3 -> Type of Software BBS (See types below)
  60. 0000                  #4 -> Serial Number for The Registered Version
  61. C:\VIEWPIX\SAMPLE.LST #5 -> Fully qualified Drive\Path\Filename
  62. C:\VIEWPIX\SAMPLE.DIR #6 -> Fully qualified Drive\Path\Filename
  63. D:                    #7 -> Drive specified as a Work Directory or NONE
  64. 7                     #8 -> Default VIEWPIX Configuration
  65. 456789                #9 -> Configuration Options Allowed
  66.  
  67. LINE NUMBER EXPLANATION
  68.  
  69. Line # 3 above can be specified for the following BBS software programs:
  70.  
  71.                   GAP  - GAP BBS which uses DOOR.SYS
  72.                   SF   - SPITFIRE 3.x which uses SFDOORS.DAT & DOOR.SYS
  73.                   WC3  - WILDCAT! 3.x which uses DOOR.SYS
  74.                   WWIV - WWIV which uses CHAIN.TXT
  75.                   PCB  - PCBOARD -> DOOR.SYS only!
  76.                   RBBS - RBBS which uses DOORINFOn.DEF
  77.  
  78. Line # 5 and 6 are critical to VIEWPIX operation! These lines must be
  79. qualified DRIVE\PATH\FILENAMES. They are vital to VIEWPIX OPERATION!
  80.  
  81.                            SAMPLE.LST
  82.  
  83. This file contains the Drive\Path specifications for all directories on
  84. your system that contain GIF files. You can have as many specifications as
  85. needed. Only ONE SPECIFICATION PER LINE is allowed. Make sure that all
  86. subdirectories indicated actually exist on your system. Use your favorite
  87. text editor to modify this file.
  88.  
  89. Here is a basic example:   C:\SF\FILE\GIFS
  90.  
  91.                            SAMPLE.DIR
  92.  
  93. This file contains the "Header Names" for each directory in SAMPLE.LST.
  94. If you system has several directories with a variety of GIF files, you
  95. can place a descriptive name here, ONE PER LINE, with a preceding number
  96. followed by a space.` NOTE: Sample.LST and Sample.DIR MUST have the same
  97. number of lines.
  98.  
  99. Here is a basic example:  1 GIFS
  100.  
  101. SAMPLE.LST and SAMPLE.DIR contain directory information which VIEWPIX
  102. uses to find and display the GIF files on your system.
  103.  
  104.               CREATE A BATCH FILE TO RUN THE PROGRAM
  105.  
  106. Each BBS program has its own set of rules for creating Door Batch Files.
  107. Refer to your own BBS manual for information on setting up your Doors and
  108. batch files to run them. The following is an example of a batch file for
  109. SPITFIRE 3.x which is placed into the SF.BAT file:
  110.  
  111. :DOOR_V                          -> Door to be executed (A-Z)
  112. @ECHO OFF                        -> Preferred Command
  113. COPY SFDOORS.DAT C:\SF\DOOR_V    -> Copy SFDoors.Dat into the Directory
  114. CD\SF\DOOR_V                     -> Change to the directory
  115. VIEWPIX VIEWPIX.CNF              -> Run VIEWPIX with the VIEWPIX.CNF File.
  116. ERASE SFDOORS.DAT                -> Erase SFDoors.Dat
  117. CD\SF                            -> Change to the main SF Files directory
  118. GOTO LOOP                        -> Return to the BBS
  119.  
  120. If you encounter a problem with the above configuration, try adding the
  121. parameter  WC3  in place of  SF  in the VIEWPIX.CNF file. When you access
  122. the doors locally with ALT-Q you will view the door in monochrome mode. If
  123. you access the door using ALT-S it will be in color. You will not be able
  124. to view the GIF file on your screen locally but will know it is working
  125. properly.
  126.  
  127.                            GAP BBS
  128.  
  129. We will call this batch file VIEWPIX.BAT as an example:
  130.  
  131. @ECHO OFF
  132. C:\
  133. CD\VIEWPIX
  134. VIEWPIX VIEWPIX.CNF
  135. C:\
  136. CD\GAP
  137.  
  138. The line above that runs VIEWPIX can have any filename as a parameter.
  139. Make sure you place you have the filename. (As in SAMPLE.CNF above) in the
  140. door directory. The extensions .LST and .DIR can be any name you choose as
  141. long as you place the same names in the VIEWPIX.CNF file!
  142. You have done a good job! The VIEWPIX DOOR should run now, if you have set
  143. it up properly.
  144.  
  145. Lines #8 and #9 refer to the type of graphic that GIFDESK will compose.
  146. Examine the following descriptions:
  147.  
  148.             #    GRID                      RESOLUTION
  149.            --------------------------------------------
  150.            1 -> 1 x 1 Grid                    640x480
  151.            2 -> 1 x 1 Grid                    800x600
  152.            3 -> 1 x 1 Grid                   1024x768
  153.            4 -> 2 x 2 Grid                    640x480
  154.            5 -> 2 x 2 Grid                    800x600
  155.            6 -> 2 x 2 Grid                   1024x768
  156.            7 -> 3 x 3 Grid                    640x480
  157.            8 -> 4 x 4 Grid                    800x600
  158.            9 -> 5 x 5 Grid                   1024x768
  159.  
  160. Line number 8 is the DEFAULT setup you wish the door to start with. Users
  161. can modify this to any of the permitted options (1 Thru 9) which you place
  162. on line number 9.
  163.  
  164.                            DOOR OPERATION
  165.  
  166. Your users are going to LOVE this Door! How many times have you downloaded
  167. large GIF files only to find that they weren't really what you expected?
  168. VIEWPIX solves that problem! This is what actually happens:
  169.  
  170. 1. Users can display files listings of all your GIFs and, depending on how
  171.    they choose to configure VIEWPIX, download and/or "Preview" a single
  172.    GIF file containing the pictures they have selected.
  173.  
  174. 2. GIFDesk, an amazing software program, is responsible for making up this
  175.    "Preview" possible! VIEWPIX passes filenames to GIFDesk and GIFDesk
  176.    works its magic. VIEWPIX then takes the "Preview" file, assigns it a
  177.    unique DOS filename and sends it to the user.
  178.  
  179. 3. If the users has SHOWGIF loaded as a TSR, they will see the graphic as
  180.    it is downloaded into their system! If not, they can look at the
  181.    "Preview"  file afterwards with their favorite GIF viewer.
  182.  
  183.                             DSZ.COM/DSZ.EXE
  184.  
  185. Before I forget - VIEWPIX also needs DSZ to perform file transfers. DSZ
  186. from Omen Technologies is a fine protocol tool package that all Sysops
  187. should use. Get it and REGISTER IT! Make sure it is placed in your PATH
  188. for VIEWPIX to find it.
  189.  
  190.                           RUNNING VIEWPIX LOCALLY
  191.  
  192. Log on locally, go into VIEWPIX and have it make a preview for you. You
  193. will not be able to view the file online. You will be able to store the
  194. file into any directory you choose for later viewing with your favorite
  195. GIF viewer. OR...  Load up SHOWGIF and give No Anchovies BBS a call!
  196.  
  197.                             SYSOP INFORMATION
  198.  
  199. VIEWPIX is written in  QuickBASIC 4.5 using Kenny Gardner's GAPQBDR Door
  200. Library. VIEWPIX has been compiled to "stand alone" and needs NO FOSSIL
  201. driver or Runtime library to execute. As a Sysop, you have certain function
  202. keys available to you while your user(s) are in VIEWPIX.
  203.  
  204.  
  205. [F5]                      -> Shell To DOS ("Exit" brings you back)
  206. [F8]                      -> Twit The User Back To The BBS
  207. [F10]                     -> Chat With User
  208. ESC                       -> Ends Chat
  209. [HOME]                    -> Main User Stats In Sysop Window
  210. [END]                     -> Displays Sysop Function Keys
  211. [PgDn]                    -> Additional User Stats
  212. [Up Arrow]                -> Increases User's Remaining Time
  213. [Dn Arrow]                -> Decreases User's Remaining Time
  214.  
  215.  
  216.                        ***** IMPORTANT *****
  217.  
  218.             DO NOT ALTER FILES "VIEWPIX" AND "VIEWPIXG"!
  219.            THEY HAVE NO FILENAME EXTENSION. ALTERING THESE
  220.               TWO FILES WILL RENDER VIEWPIX INOPERABLE!~
  221.  
  222.                             REGISTRATION
  223.  
  224. VIEWPIX  registration is only $35.00 payable by Check or Money Order to:
  225.  
  226.                               No Anchovies PC
  227.                              1205 Lake Avenue
  228.                             Ashtabula, OH 44004
  229.  
  230. The Unregistered demo version will only allow (10) GIF files to display
  231. in only one directory.
  232.  
  233. After registering, you will be given access to the VIEWPIX support forum on
  234.  
  235.                              No Anchovies BBS
  236.                               (216) 466-1152
  237.                               (216) 466-1153
  238.                           (Both HST DUal Standard)
  239.  
  240.    It is here that you will receive a Serial Number to register VIEWPIX.
  241.    Please address any questions, comments, etc., in a comment to the SYSOP
  242.    on No Anchovies BBS.
  243.  
  244.